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^ ■ Abstract 

We describe the FeynEdit tool for drawing Feynman diagrams. Input and output 
Oh| is done using the WT^^ macros of FeynArts, which also implies that diagrams drawn 

(—j I by FeynArts can be edited with FeynEdit. The I^Te^ code can be conveniently 

transferred using copy-and-paste. 



!^ ■ 1 Introduction 

The FeynArts package [1] can paint Feynman diagrams and export them as BTgX code, 
such that they can be included directly in publications. For example, the diagram 




is represented by the I^TgX code 

\FAProp (0 . , 10 . ) (6 . , 10 . ) (0 . , ) {/Straight}{0} 
\FALabel (3 . , 9 . 18) [t] {$1$} 

\FAProp (20 . , 10 . ) ( 14 . , 10 . ) (0 . , ) {/Straight}{0} 
\FALabel ( 17 . , 10 . 82) [b] {$2$} 
\FAProp(6. ,10.) (14. ,10.) (0.8,){/Straight}{0} 
\FALabel ( 10 . , 5 . 98) [t] {$3$} 

\FAProp (6 . , 10 . ) ( 14 . , 10 . ) (-0 . 8 , ) {/Straight}{0} 
\FALabel ( 10 . , 14 . 02) [b] {$4$} 
\FAVert(6. ,10.){0} 
\FAVert(14. ,10.){0} 
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The elements of the diagram are easy to recognize and it is straightforward to make changes 
e.g. to the label text. It is less straightforward, however, to alter the geometry of the 
diagram, i.e. to move vertices and propagators. 

The new tool FeynEdit fills this gap by allowing the user to copy-and-paste their ETgX 
code of the Feynman diagram into the editor, visualize the diagram, modify it using the 
mouse, and finally copy-and-paste it back into the text. 

2 Installation 

The FeynEdit package can be downloaded from http://www.feynarts.de. Unpack the 
tar- file and run make, for example: 

gunzip -c FeynEdit-n.m.tar.gz I tar xvf - 

cd FeynEdit-ri.m 

make 

The package contains both the source files and the compiled Java byte-code. The actual 
Java program is FeynEdit. jar and the above make command only turns the jar-file into 
a regular executable by adding the script signature with the full path of the local system's 
Java interpreter. On Windows with a Java Runtime installed (http://www.java.com), 
FeynEdit . j ar executes directly when double-clicked. 

3 Usage 

The editor is started by typing FeynEdit at the command line or by double-clicking on 
the FeynEdit . j ar icon on Windows. The start-up screen is shown in Fig. [TJ 

The window is divided into an upper panel for the diagram display and a lower panel 
which shows the I^T^K code. To display an existing Feynman diagram, mark its KT^X 

code with the mouse and paste it into the lower dialog box. Then press the ^ button 
to display the diagram. Otherwise, start with an empty canvas and use the mouse to add 
elements. 

When finished with editing, press the ^ button to turn the diagrams into KT[TiX code, 
then pick up the latter with the mouse and paste it (back) into your text. 

Just as in the Topology Editor of FeynArts, vertices are marked with red, propagators 
with blue, and labels with green squares. When clicking on a square, the corresponding 
entity becomes marked and the square is drawn a little larger. 

Propagators come in two varieties which have to be distinguished for editing purposes: 
tadpoles, with coincident initial and final vertices, and 'ordinary' propagators. 

The diagram can be edited with the mouse. Four editing functions are available: 

• Move vertices, propagators, and labels: Click on the corresponding box (red, blue, 
green) and drag it to the desired position. 
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Figure 1: The start-up screen of FeynEdit. 

• Draw tadpoles: Click on the 'footpoint' of the tadpole and drag it to the desired size 
and orientation. 

• Draw 'ordinary' propagators: Click on the starting point and drag to the end point. 

• Delete objects: Click on the square (red, blue, green) corresponding to the object 
you want to delete. When deleting a vertex, the propagators adjacent to this vertex 
are also deleted. When deleting a propagator, the corresponding label is also deleted. 

In the default setup, the left mouse button moves objects, the middle mouse button draws 
tadpoles, and the right mouse button draws propagators. The assignment of the mouse 
button can be changed in the Mouse Button Assignment menu (Fig. [21 right panel). 
Following is an overview of all buttons: 



gF] Interpret the M^TjX code and display the diagrams. 
^ Turn the edited diagrams into DTgX code. 



§1 Turn on Grid Snap, i.e. restrict a dragged object's location to lie on a grid position 
('quantize' the drag movement). This is to aid the aligned placement of items. 
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ALabel(3.51229,6.78g26)[tn;ie3) 

APrap(2D.,15.)(14.,l[).HO.,)[/StrEiightHl( 

ALsbel(16.4877,13.21£)7)[br]fS\muS) 

AProp(20.,5.K14..10.l(0.,IS/S!raightK-l| 

ALabeia7.S123,S,21074)[bll(S\muS} 

AProp(6.,10.K14.,10.l(0.,15^SmeH01 

ALibel(10..e.93)[tJ5i\gammi,ZS) 

AVert(6.,10.)[0( 

AVerc(14.,10.)fO} 




^Delete 

^ Previous Diagram P 
^ Next Diagram hi 

9 Undo '■Z 
C Redo 



^ Grid Snap Off 



Middle Button 
Right Button 
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2 ® Move 

^ C Draw Propagatot* 
mO DrawTadpoie 
10 Delett 



\FALabei(3.S1229,6.7e926)[tiKJeS) 

\FAPrap(2[).,15.K14.,10.KO.,)[/StraighlHlJ 

\FALabei(16.4e77,13.21071[br]{J\niu51 

\FAProp(20.,5.K14.,10.)(0..)[/StralghtH-l) 

\FALabel(17.5123,B.21074)[bi](S\muS( 

\FAProp(6.,10.K14.,10.)(0.,)[/SineK01 

\FALabei(10.,8.93)|tJ[S\gamma.ZS} 

,\FAVErt(6.,10.K0) 

ji\FAVert(14.,10.)f01 



Figure 2: Left panel: The diagram pasted into FeynEdit and displayed. Right panel: The 
Mouse Button Assignment Menu in FeynEdit. 
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Turn off Grid Snap, i.e. allow objects to be dragged to arbitrary positions. 



^ Move forward one diagram. For this button to become active, the f^T^X code must 
contain more than one diagram, separated by \FADiagram directives. 

^ Move back one diagram. 
^ Undo last change. 
^ Redo last undone change. 
Clear panel. 




^ Delete the currently marked entity. 

1^ Copy the contents of the I^T^K panel into the copy-and-paste buffer. 

Paste the current copy-and-paste buffer into the KT[t;X panel. 

Note that details of the diagram, such as line attributes and label texts, are neither 
displayed by the editor, nor can they be specified for new tadpoles and propagators. Thus, 
for example, a gluon line is not drawn as a cycloid. This is largely for performance reasons 
(think of dragging a gluon line) and may be added in a future version. At any rate, it is 
not a serious deficit because that information can easily be added in the WT]^ code. For 
instance, the line 

\FAProp (0 . , 10 . ) (6 . , 10 . ) (0 . , ) {/Straight}{0} 

refers to a straight line. Simply changing "Straight" to "Cycles" makes it a gluon line. 
The next section gives all such details on the FeynArts I^TgX style. 

4 Graphics Primitives in feynarts.sty 

The FeynArts style is included in a BTfTjX 2e document with 

\usepackage{f eynarts} 
It makes three graphics primitives available with which Feynman diagrams can be drawn: 

• \FAProp draws a propagator, 

• \FAVert draws a vertex. 
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• \FALabel places a label. 

In addition, it provides formatting/geometry directives: 

• \begin. . . end{f eynartspicture} delineates a sheet of Feynman diagrams, 

• XFADiagram advances to the next diagram. 

Since f eynarts . sty emits direct PostScript primitives, the interpretation of which is non- 
standard across PostScript renderers, it is guaranteed to work only with dvips. 

4.1 Geometry 

A single Feynman diagram is always drawn on a 20 x 20 canvas. Several such canvasses are 
combined into a rectangular sheet which can optionally carry a title. See Fig. [3] for illus- 
tration. Such a sheet of Feynman diagrams is enclosed in a f eynartspicture environment 
in KTeX: 

\begin{f eynartspicture} ,Sy) {n^jUy) 

\end{f eynartspicture} 

This sheet has a size of x Sy (in units of KT^X's \unitlength) with room for x Uy 
Feynman diagrams. Uy need not be an integer and the extra space implied by the fractional 
part is allocated at the top for the sheet label. 

Note that it is not possible to distort the aspect ratio of a Feynman diagram. If the ratio 
nx/\ny\ is chosen different from the ratio s^/sy, the sheet will fit the smaller dimension 
exactly and be centered in the larger dimension. 

Inside the f eynartspicture, the macro 

\FAD i agr am{ dtitle } 

advances to the next diagram, which has the title dtitle. The size of dtitle can be changed 
by redefining \FADiagramLabelSize with one of the usual I^TgX font-size specifiers, e.g. 

\renewcommand\FADiagrainLabelSize{\scriptsize} 

The default size is \ small. 

4.2 Propagators 

All propagators are circular arcs in the FeynArts style. This includes conceptually the 
straight line as the infinite-radius limit. Propagators furthermore come in two variants: 
tadpole propagators, where the initial and final vertex coincide, and 'ordinary' propagators 
with distinct initial and final vertex. This distinction is necessary because the information 
that has to be stored is different for the two cases. The arguments of the \FAProp macro 
and their geometrical meaning are shown in Fig. H] for both variants. 
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Figure 3: Geometry of a 2 x 2 f eynartspicture sheet. 
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{fx, fy) 

\FAProp(/^,/j^) {fx,fy) (Cx,Cy')-ig}ia} \FkProp(fx ,fy) (.t^.ty) (K,,')ig}ia} 

The latter two arguments, g and a, respectively determine line and arrow style: 

g = /Straight a = 

g = /ScalarDash ► a = 1 

g = /GhostDash ^ a = — 1 

nnnnnnr 9 = /cycies 

Note the slash (/) in the line-style directive which is necessary because the directive is 
directly handed to the PostScript interpreter. 

Figure 4: The geometrical layout of a propagator and the corresponding arguments of 
the \FAProp macro. Left: tadpole-type propagators (coincident initial and final vertex). 
Right: 'ordinary' propagators (non-coincident initial and final vertex). 
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4.3 Vertices 

Vertices mark the points where propagators join. Each propagator has a counter-term 
order associated with it. 

• OO • X (g)0 

\FAVert(x,|/){o} o= ••• -3 -2 -1 1 2 3 ••• 



4.4 Labels 

Labels are usually associated with propagators, but can in principle be set anywhere. They 
have a pair of coordinates and an alignment, given in the usual TgX manner, i.e. a code 
of up to two letters for vertical and horizontal alignment: {t = top, (empty) = center, b = 
bottom} (8> {1 = left, (empty) = center, r = right}, e.g. [t] or [rb] . The alignment makes 
it possible to change the label's text, in particular its width, without having to reposition 
the coordinates. 

\FALabel (x ,y) lalignl {.text} 



5 Summary 

FeynEdit is a Java program for editing Feynman diagrams. It uses the f^TgX representation 
of FeynArts for input and output. Diagrams are entered into and retrieved from the editor 
through cut-and-paste with the mouse. This makes it unnecessary to first save the diagrams 
one wants to edit in a separate file. 

The editor does not show details such as line styles and the actual labels. This is 
currently done for performance reasons. With the FeynArts BT[HjX format, it is not difficult 
to change these elements later, however. 

The package is open source and is licensed under the LGPL. It can be downloaded from 
http://www.feynarts.de and runs on all platforms with a Java interpreter. 
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